home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / antisb32.zip / ANTISUB.DOC < prev    next >
Text File  |  1996-07-03  |  6KB  |  155 lines
  1.                               ANTISUB 3.2
  2.  
  3.  
  4. Antisub is a program to bounce outgoing mail messages which request a 
  5. subscription to a newsnet news group (for example).
  6.  
  7. Command line:
  8.  
  9.         ANTISUB 
  10.  
  11. Antisub searches EVERY file in the current directory for a line 
  12. containing TO:, this is assumed to be a destination address line for 
  13. a mail message. This line is then searched for containing any of the 
  14. strings which are stored in the file antisub.cfg (in the antisub
  15. directory). The search is case insensitive and multiple occurences of 
  16. white space are reduced to a single space, so that: 
  17.  
  18.         SUBS
  19.  
  20. all match with "TO: SUBS", and "TO:SUBSCRIBE" and 
  21. "TO: !ALT.BIN.SUBSCRIBE"
  22.  
  23. Any messages found to be addressed illegally then have their 
  24. destination address (TO: ...... ) destroyed so that the message is 
  25. bounced back to the originator. 
  26.  
  27. It appears that some internet mail systems do not return undeliverable 
  28. mail back to the BBS. For these BBS you can specify a diversion 
  29. internet address in the file ANTISUB.ADR to which all bounced messages 
  30. will be diverted. If the file ANTISUB.ADR does not exist, the target 
  31. address of BOUNCED will be used as before. ANTISUB.ADR should contain 
  32. two lines. The first line is the diversion address such as: 
  33.  
  34.         divert@address.com
  35.  
  36. and the second line is simply blank.
  37.  
  38. A message is then inserted at the top of the message telling the 
  39. originator what has happened. In the shareware version this message is 
  40. hard coded as: 
  41.  
  42. ----------------------------------------------------------------------
  43. | This message was not delivered because the Sysop has deemed that   |
  44. | the addressee is illegal on this BBS                               |
  45. |                                                                    |
  46. | (Antisub V3.2 - Unregistered Shareware Version)                    |
  47. ----------------------------------------------------------------------
  48.  
  49. Registered users can define their own message, up to 15 lines long 
  50. which should be a plain text file entitled "antisub.msg" and located 
  51. in the same directory as antisub.exe and antisub.cfg.
  52.  
  53. A copy of the original bounced message is appended to the log file, 
  54. ANTISUB.LOG which may be found in the ANTISUB.EXE directory.
  55.  
  56. An additional bonus for registered users is being able to create their 
  57. own signature lines (ANTISUB.SIG, upto 15 lines) which is appended to 
  58. the end of all message files processed by ANTISUB (whether they are 
  59. bounced or not). This file should have the name ANTISUB.SIG and must 
  60. be located in the directory with antisub.exe. Unregistered versions of 
  61. antisub append an identifying string to the end of messages. 
  62.  
  63. Any messages originating from adresses listed in the optional "don't 
  64. bounce" file ANTISUB.NOB will be passed. This allows you to define a 
  65. list of super users who are allowed to subscribe, such as yourself!
  66. Each line in the ANTISUB.NOB file should contain an origination 
  67. address to allow to subscribe such as:
  68.  
  69.         sysop@bbs.com
  70.  
  71. Do NOT use short names like peter, or every Peter who sends messages 
  72. will be able to subscribe, that is the following names would be 
  73. matched:
  74.  
  75.         peter.jones@bbs.com
  76.         sally.peters@bbs.com
  77.         peter@bbs.com
  78.  
  79.  
  80. IMPORTANT!
  81.  
  82. Antisub.exe, antisub.cfg and any other optional antisub files must be 
  83. located in a single directory in the DOS searchpath, and NOT in the 
  84. outgoing mail directory, but must be run with the outgoing mail 
  85. directory as the current directory. 
  86.  
  87. For example; 
  88. copy antisub.exe and antisub.cfg into a tools directory, say C:\TOOLS
  89. and then in a batch file change directory to the outgoing mail 
  90. directory, such as "cd \outmail" and then run antisub.
  91.  
  92.  
  93.                          QUICK FILE REFERENCE
  94.  
  95.  
  96. All files must be located in the same directory.
  97.  
  98. ANTISUB.EXE        Executable program
  99. ANTISUB.ADR        Optional Diversion address file
  100. ANTISUB.CFG        Target Sub-Addresses to force message bounce
  101. ANTISUB.LOG        Log of activity (generated by ANTISUB)
  102. ANTISUB.MSG        Optional "Why this message was bounced" Message 
  103.                    file (Registered version only)
  104. ANTISUB.NOB        Optional list of Originator Sub-Addresses to
  105.                    suppress message bouncing
  106. ANTISUB.SIG        Optional signature to append to all messages
  107.                    (Registered version only)
  108.  
  109.  
  110.  
  111.  
  112. Antisub is shareware. You are licensed to use this software for a 
  113. period not exceeding 30 days from when you got it to evaluate its 
  114. suitability for your needs. After that you should either stop using it 
  115. or register it by sending 20 pounds UK currency to:
  116.  
  117. Matthew Probert
  118. 5 Longcroft Close
  119. Baingstoke
  120. Hampshire
  121. RG21 8XG
  122. England
  123.  
  124. Telephone:      01256 414072
  125. Internet:       probertm@pins.co.uk
  126. WWW:            http://pins.co.uk/upages/probertm
  127.  
  128.  
  129.                                WARNING!
  130.  
  131. Periodically the unregistered version of antisub will not bounce an 
  132. illegally addressed message, but rather will destroy the original 
  133. message and forward the message header to me (minus any message text). 
  134. Thereby identifying your bbs with a return address as a user of the 
  135. unregistered version. After a while if I don't receive a registration, 
  136. but continue to receive notice that you are using the program I shall 
  137. be on to you! 
  138.  
  139.  
  140.                                 CREDITS
  141.  
  142.  
  143.  
  144.            Conception:     Peter Friedlos
  145.  
  146.            Design:         Matthew Probert & Peter Friedlos
  147.  
  148.            Coding:         Matthew Probert
  149.  
  150.            Testing:        Matthew Probert & Peter Friedlos
  151.  
  152.            Documentation:  Matthew Probert
  153.  
  154.            Support:        Matthew Probert
  155.